home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / fish / 676-700 / 687 / powerplayer / powerplayer.dok < prev    next >
Text File  |  1995-03-18  |  17KB  |  388 lines
  1.  
  2.             P O W E R P L A Y E R
  3.  
  4.             -Bedienungsanleitung-
  5.  
  6. Copyright
  7. ---------
  8. PowerPlayer ist FreeWare, das bedeutet daß er frei kopierbar ist, solange
  9. das Paket unverändert und komplett mit den Dateien PowerPlayer,
  10. PowerPlayer.DOC, PowerPlayer.DOK, PowerPlayer Music Cruncher, ReqToolsLib,
  11. PowerPackerLib, LhLib und dem Installations-Script weitergegeben wird.
  12. Wenn Sie etwas ändern möchten -» schreiben Sie mir zuerst !  Ich kann nicht
  13. garantieren, daß alle Dateien in diesem Paket frei kopierbar und/oder
  14. Public Domain sind.
  15.  
  16. Die Lieder 'Factory' & 'SL-Nights2' wurden 1991 von Stephan Fuhrmann mit
  17. Teijo Kinnunen's wundervollem MED geschrieben ! Sie sind ebenfalls FreeWare,
  18. aber müssen nicht unbedingt mit dem PowerPlayer vertrieben werden.
  19.  
  20.         © 1991/92 STEPHAN FUHRMANN, WEST-GERMANY
  21.  
  22. Diese frei kopierbaren Funktionsbibliotheken gehören zum PowerPlayer-Paket:
  23.  
  24. -ReqTools.Library © Nico François
  25. -PowerPacker.Library © Nico François
  26. -Lh.Library © Holger P.Krekel und Olaf 'Olsen' Barthel
  27.  
  28. Version 2.7 13.6.1992
  29.  
  30. Grüße
  31. -----
  32. Grüße gehen an
  33. -Mutti
  34. -Delta/TCC für die starke REAL DINKELATOR DOPPELBOCK INTRO !
  35. -Flynn/TRSI für seinen bärigen NoisePlayer
  36. -Romeo Knight/RSI dafür, daß er der beste Musiker auf der Welt ist
  37. -Holger P.Krekel & Olaf 'Olsen' Barthel für ihre LH.Library
  38. -Nico François für seine tolle Reqtools.Library & PowerPacker.Library und
  39.  seinen Tips über die Reqtools.Library
  40.  
  41. Geschichte
  42. ----------
  43. V 1.0:    Version mit BUGS & ohne nette Features :-(
  44. V 1.1:    Alle BUGS entfernt, niedliches CLI-Interface & CLI-Infoseite, PMC
  45. V 1.2:    (endlich) Oktalyzer 4-Voice Replay hinzugefügt
  46. V 1.3:    DeltaMusic hinzugefügt, PowerPlayer erkennt jetzt
  47.     alle SoundMon-Versionen, ProTracker-Replay optimiert
  48. V 1.5:    Man kann nun auch für den Datei-Requester ein Verzeichnis festlegen
  49.     (sehr nützlich !), das NoisePacked 1.3D-Replay, das aus irgendwelchen
  50.     Gründen in allen anderen Versionen mal ausgeschaltet war, ist nun
  51.     endlich erhältlich !
  52. V 1.6:    Die inzwischen gealterte Req.Library wurde durch die ReqTools.Library
  53.     ersetzt, die unter anderem schöne 3D-Requester erlaubt.
  54. V 1.7:    Anstelle eines VBlank-Interrupts, der auf Amigas mit NTSC oder
  55.     einem 10 Hz-Monitor Songs mit unnatürlichen Geschwindigkeiten
  56.     fabriziert, wurde ein CIA-Timerinterrupt benutzt.
  57. V 1.8:    Die "Restart"-Funktion wurde hinzugefügt
  58. V 1.9:    Der Fehlerausgabe wurde verbessert, die ECLOCK-Frequenz wird jetzt,
  59.     sofern OS 2.0 benutzt wird, vom System geholt, Abspielroutinen wieder
  60.     optimiert, fand einen Fehler, der in ALLEN Tracker-Abspielroutinen
  61.     existiert - er schreibt in unbelegten Speicher. Ich weiß nicht, ob
  62.     dieser schwerwiegende Fehler in allen anderen Module-Abspielprogrammen
  63.     existiert. Ich empfehle, nur noch PowerPlayer zu benutzen !
  64. V 2.0:  Eine Routine für TFMX-Module mit eingebauter Abspielroutine
  65.     wurde hinzugefügt
  66. V 2.1:    Eine Routine für MED-Module wurde hinzugefügt
  67. V 2.2:  Eine echte grafische Benutzeroberfläche mit einem
  68.     CD-Player-ähnlichen Knopfsystem. Jetzt wird ein großer Lh-Buffer
  69.     für schnelleres Entpacken verwendet.
  70. V 2.3:  Wenn man nun die rechte Maustaste drückt verkleinert/vergrößert
  71.     sich das Fenster, beim Programmstart wird das Fenster unter dem
  72.     Mauszeiger zentriert, neue Tastaturkürzel wurden hinzugefügt,
  73.     der Code wurde optimiert
  74. V 2.4:    Neue Funktionen: Erster Song, letzter Song, Zufalls-Song !
  75. V 2.5:    PowerPlayer zeigt nun einen Busy-Mauszeiger, wenn er lädt und
  76.     entpackt. Gleichzeitig wird dann der IDCMP des Fensters gesperrt.
  77. V 2.6:    PowerPlayer sieht nun auch auf einem 2-Farb-Schirm gut aus
  78. V 2.7:  Ein wenig mehr WB 2.0-Feeling durch 3D-Rahmen
  79.  
  80. Diese Version des PowerPlayers unterstützt:
  81.         FutureComposer 1.4
  82.         NoiseTracker (Protracker V1.1b Replay)
  83.         JamCracker
  84.         SoundMon
  85.         Startrekker 4 Voice
  86.         Fred
  87.         SidMon
  88.         NoiseTracker 1.3D packed modules
  89.         NoiseTracker 1.3D packed modules mit Abspielroutine
  90.         Mark II Sound System
  91.         NoisePacker 2.03
  92.         Oktalyzer 4 Voice
  93.         DeltaMusic
  94.         TFMX mit Abspielroutine
  95.                 MED-Module
  96. Installation
  97. ------------
  98. Der PowerPlayer benötigt die PowerPacker.Library und die ReqTools.Library
  99. in ihrem Libs:-Verzeichnis.  Der beigefügte Installations-Script in diesem
  100. Paket wird alles für sie installieren.  Wahlweise wird die Lh.Library
  101. benutzt.  Wenn sie genug Erfahrung haben können Sie mit dem PMC, welcher
  102. die Lh.Library benutzt, ihre Module packen.
  103.  
  104. Anleitung
  105. ---------
  106. Hallo und Willkommen in der Welt des PowerPlayers!  Dieses fantastische
  107. Tool wurde 1991/1992 von Stephan Fuhrmann geschrieben und benutzt die
  108. hervorragenden Fähigkeiten der
  109.  
  110. -ReqTools.Library von Nico François für die Datei- und Text-Requester
  111.  
  112. -PowerPacker.Library von Nico François um powergepackte Dateien zu entpacken
  113.  
  114. -Lh.Library von Holger P.Krekel und Olaf 'Olsen' Barthel für die beste
  115.  Kompression von Modules, ausführbarer einfacher Cruncher im Paket enthalten.
  116.  
  117. Einleitung
  118. ----------
  119. Der PowerPlayer ist ein Tool, um Musik mit dem guten alten AMIGA STEREO
  120. DIGITAL SOUND abzuspielen, die mit einem der unterstützten Musik-Programme
  121. oder kompatiblen gemacht wurde.  Es gab bereits viele dieser Programme,
  122. doch PowerPlayer ist etwas anderes:
  123.  
  124. -netter schneller trickreicher 100%-iger Assembler-Code, größtenteils
  125.  PC-Relativ
  126. -kleines niedliches Play-Window
  127. -viieeelle Abspielroutinen
  128. -PowerPacker-Library um immer die neueste und schnellste Entpack-Routine
  129.  zu benutzen
  130. -Lh-Library für die beste Kompression, die je ein Module erfahren hat
  131.  (ausprobieren!)
  132. -kann in vielen Arten von der Workbench und vom CLI aufgerufen werden
  133.  
  134. Aber fangen wir am Anfang an:
  135.  
  136. Aufruf vom PowerPlayer
  137. ----------------------
  138.     WorkBench
  139.     ---------
  140.         DoppelKlick
  141.         -----------
  142.             Doppelklicken Sie das Icon vom PowerPlayer, wählen
  143.             Sie die Datei im Datei-Requester, drücken Sie 'OK'
  144.             und genießen Sie !
  145.         DefaultTool
  146.         -----------
  147.             Sie haben ein Modul mit Icon. Wählen Sie das
  148.             Icon an und aktivieren Sie die Info-Funktion der
  149.             Workbench. Nun wählen Sie das DefaultTool an.
  150.             Geben sie den Pfad des PowerPlayers ein. Drücken
  151.             Sie das 'SAVE'-Gadget. Immer wenn Sie jetzt das
  152.             Projekt-Icon doppelklicken, wird der PowerPlayer
  153.             geladen und den Song abspielen.
  154.         Mehrfachauswahl
  155.         ---------------
  156.             Bewegen Sie den Mauszeiger über das PowerPlayer-Icon
  157.             und drücken Sie den linken Mausknopf einmal. Drücken
  158.             Sie jetzt SHIFT und lassen Sie es gedrückt.
  159.             Wählen Sie die Songs, die Sie hören wollen, mit der
  160.             Maus aus. Doppelklicken Sie den letzten Song und
  161.             lassen Sie SHIFT los. Ihre Songs werden geladen !
  162.  
  163.     CLI/SHELL
  164.     ---------
  165.         DateiRequester
  166.         --------------
  167.             Jeder weiß, wie man Dateirequester bedient, also
  168.             werde ich den sehr guten Dateirequester der
  169.             ReqTools.Library nicht erklären. Geben Sie den Namen
  170.             des PowerPlayers in der CLI/SHELL, das Sie geöffnet
  171.             haben mit dem Parameter '-r' ein. Es erscheint ein
  172.             DateiRequester und Sie können ihre Songs aussuchen.
  173.             Beispiel: PowerPlayer -r
  174.         Dateiname
  175.         ---------
  176.             Wenn Sie keine Datei mit einem Requester auswählen
  177.             wollen (z.B. in Scripts), können sie ebenfalls
  178.             den Modulnamen mit seinem Pfad an die Kommandozeile
  179.             hängen.
  180.             Beispiel: PowerPlayer df0:modules/MOD.PowerTheme
  181.         Verzeichnis
  182.         -----------
  183.             Es gibt seit der Version 1.5 die Möglichkeit, den
  184.             PowerPlayer vom CLI mit einem Filerequester zu
  185.             starten, der dann schon in einem vom Benutzer
  186.             festgelegten Verzeichnis ist. Es wird einfach das
  187.             Verzeichnis an die Kommandozeile gehängt.
  188.             Beispiel: PowerPlayer ST-00:modules
  189.         Information
  190.         -----------
  191.             Wenn Sie den Informations-Bildschirm sehen wollen,
  192.             geben Sie folgendes ein:
  193.             PowerPlayer ?
  194.  
  195. Play-Requester
  196. --------------
  197. Der Play-Requester enthält Informationen zum Modul und einige Gadgets.
  198. Alle Versionen +2.1 haben ein neues Benutzerinterface. Es gibt ein
  199. Haupt-Fenster, das dort bleibt wo es ist solange der PowerPlayer läuft:
  200.  
  201. Fragezeichen....zeigt die üblichen Informationen über das Copyright und
  202.         die Features.
  203.         Taste: "1"
  204. Eject...........verwirft die aktuelle Songliste & holt sich über einen
  205.         Filerequester eine neue.
  206.         Taste: "2" oder "e"
  207. FirstSong.......lädt und spielt den ersten Song aus der Liste
  208. PrevSong........lädt und spielt den vorangehenden Song aus der Liste.
  209.         Taste: "3", "[", "(" oder "{" !
  210. Play............spielt den Song ab. Entfernt automatisch Pause,
  211.         wenn man wieder auf PLAY hämmert startet der Song neu.
  212.         Taste: "4" oder "p" !
  213. FastForward.....spielt den Song mit doppelter Geschwindigkeit. Ergibt
  214.         einen schönen FF-Effekt ! Nochmal raufhämmern schaltet
  215.         wieder auf normale Geschwindigkeit.
  216.         Taste: "5" oder "f"
  217. NextSong........lädt & spielt den nächsten Song aus der Liste.
  218.         Taste: "6","<RETURN>", "]",")" oder "}" !
  219. LastSong........lädt & spielt den letzten Song aus der Liste.
  220. Stop............stoppt den Song. Deaktiviert automatisch Pause, FF und
  221.         Play !
  222.         Taste: "7" oder "s"
  223. Pause...........stoppt den Song, bis nochmal Pause betätigt wird oder
  224.         Play gedrückt wird.
  225.         Taste: "8" oder "<LEERTASTE>"
  226. Reset...........startet den Song von neuem.
  227.         Taste: "9" oder "r"
  228. RND.............lädt und spielt einen zufällig gewählten Song ab.
  229.         Taste: "~" oder "/"
  230.  
  231. Fast jedes Gadget hat eine dazugehörige Taste (Tasten 1-9), ESC oder CTRL-C
  232. beenden den PowerPlayer.
  233.  
  234. CTRL-F bringt das Fenster auf volle Größe vor alle anderen Fenster.
  235.  
  236. Wenn man die rechte Maustaste drückt, wechselt man in den Iconify-Modus.
  237. Das Fenster schrumpft auf eine minimale Höhe von 10 Pixeln. Die Gadgets
  238. verschwinden zwar, jedoch kann man den PowerPlayer weiterhin mit den
  239. Tastatur-Kürzeln kontrollieren.
  240. Um das Fenster wieder auf seine normale Größe zu bringen muß man
  241. lediglich die rechte Maustaste erneut drücken.
  242.  
  243. Die Anzeige des Fensters beinhaltet
  244. -den Namen des Modules (oben im Fenster)
  245. -Typ & Länge des Modules in Bytes (Mitte des Fensters)
  246. -Gadgets und Positions-Anzeiger, welcher die derzeitige Position in der
  247.  Dateiliste anzeigt.
  248.  
  249. Mein GUI (Grafische Benutzerschnittstelle) arbeitet mit einer
  250. Recolor-Routine, die verrückte Paletten recht gewitzt behandelt. Sie sucht
  251. nach der hellsten und dunkelsten Farbe für die Schatten und sucht nach der
  252. Farbe mit dem größten Kontrast zum Hintergrund für die Textausgabe.
  253.  
  254. Der PowerPlayer Music Cruncher
  255. ------------------------------
  256. Es gibt mächtigere Datenpacker als den PowerPacker, doch LhArc hat ein
  257. komplexes Datei-Format und der IMPLODER hat keine erklärte Funktion in
  258. seiner explode.library, um Dateien des File-Imploders zu entpacken, also
  259. war ich sehr froh als ich die Lh.Library erhielt und endlich meinen eigenen
  260. Packer/Entpacker zu meinem PowerPlayer hinzufügen konnte.  Die Benutzung
  261. des PMC ist sehr einfach.  Sie müssen einfach ein CLI/SHELL öffnen und PMC,
  262. gefolgt vom Namen der zu packenden Datei und der Zieldatei, eingeben.
  263. Beispiel:
  264.  
  265. PMC df0:modules/MOD.PowerTheme df0:modules/MOD.PowerTheme.LH
  266.  
  267. PMC gibt dann irgendetwas wie
  268.  
  269. Crunching df0:modules/MOD.PowerTheme, Please stand by !
  270.  
  271. aus, und nach einer unwichtig kleinen Zeit (99 Sekunden) wird er das Ergebnis
  272. anzeigen:
  273.  
  274.     Result
  275.     ------
  276.     Uncrunched: 214418
  277.     Crunched: 158052
  278.     Percentage: 73
  279.  
  280. PowerPacker packte die selbe Datei in 109 Sekunden, packte Sie jedoch nur
  281. zu 168760 bytes (78%).  Der einzige Vorteil des PowerPackers ist, daß er in
  282. 10 Sekunden entpackt (Lh:  14 Sekunden).  Ich möchte nicht, daß Nico
  283. verhungert :-), aber ich meine, daß man, wenn man den PowerPacker nicht
  284. schon hat, PMC benutzen sollte.  Oder man packt nicht, wenn man eine große
  285. schnelle Festplatte mit hunderten freier Megabytes hat (hab' ICH nicht :-(
  286. !).
  287.  
  288. Es kann passieren, daß die Prozent-Anzeige falsch ist.  Das passiert, wenn
  289. die gepackte Datei zu groß ist.  Der Grund dafür ist die 16-Bit-Quelle des
  290. CPU-Divu-Befehls.  Natürlich ist die Datei davon nicht betroffen.
  291.  
  292. PMC generiert Dateien des SFHD-Formates (Stephan Fuhrmanns Hohe Dichte :-) ).
  293. Man kann diese Dateien an der Kennung 'SFHD' in den ersten 4 Bytes erkennen.
  294. Das 2.Langwort ist die ungepackte Länge, das 3.Langwort ist die
  295. gepackte Länge.
  296.  
  297. Ich habe einige Typen gesehen, die mit dem PMC gepackte Module in Mailboxen
  298. raufgeladen haben.
  299. BITTE unbedingt '.PMC' als Suffix benutzen und schreiben, daß man den
  300. PowerPlayer zum abspielen braucht.
  301. UND unbedingt die Mailbox prüfen, ob der PowerPlayer überhaupt vorhanden
  302. ist, sonst wird so mancher ziemlich sauer sein, wenn er erst die
  303. Modules runterlädt und dann merkt, daß PowerPlayer garnicht da ist
  304. und er die Modules nicht gebrauchen kann !
  305.  
  306. Ein Beispiel-Mailbox-Eintrag könnte so aussehen:
  307. SONG.PMC    Sehr guter Song, nur mit PowerPlayer zu benutzen
  308.  
  309. Es ist unbedingt zu empfehlen, die Modules direkt im PMC-Format ohne
  310. anderen 'Müll' raufzuladen, zumal einerseits _NICHT_ per Hand
  311. entpackt werden muß, die entpackte Datei keinen Diskettenplatz
  312. verschwendet und letztendlich durch das eigens für den PowerPlayer
  313. entwickelte PMC-Format ein entpacken ohne den PowerPlayer nicht
  314. möglich ist, so daß man sich so oder so des PowerPlayers bedienen
  315. muß ß-} ! So kann man seine Zustimmung zum PowerPlayer ausdrücken!
  316.  
  317. Technische Informationen
  318. ------------------------
  319. Ein seltsames Feature der SHELL ist, daß das ALIAS-Kommando an die
  320. Kommandozeilenparameter ein Leerzeichen anhängt. PowerPlayer löscht darum
  321. sämtliche Leerzeichen vor dem Zeilenende.
  322.  
  323. PowerPlayer generiert nicht einen eigenen Prozess. Es scheint zwar modern zu
  324. sein, alles gleich im Hintergrund ablaufen zu lassen, ich jedoch wollte dem
  325. Benutzer die Möglichkeit geben, den Computer solange anzuhalten, wie ein
  326. Musikstück abgespielt wird (z.B. in der Startup-Sequence). Meiner Meinung
  327. nach ist das die beste Art, das zu realisieren, wenn Sie jedoch PowerPlayer
  328. im Hintergrund laufen lassen wollen, müssen Sie ihn selber mit "RunBack"
  329. starten.
  330.  
  331. PowerPlayer benutzt das AUDIO.DEVICE, um Audio-Kanäle zu belegen.  Ich
  332. glaube, daß PowerPlayer der einzige Modulabspieler ist, der das tut.  Der
  333. große Vorteil dieser Methode ist, daß PowerPlayer NICHT mit anderen
  334. Programmen, die die Audio-Kanäle belegen, kollidiert.  Wenn Sie jemals das
  335. Chaos, das zwei gleichzeitig laufende Modulabspieler fabrizieren, gehört
  336. haben, werden Sie dieses Feature mögen.
  337.  
  338. ACHTUNG! Benutzen Sie die NoisePacker-Routine V2.03 mit Vorsicht ! Mein
  339. Amiga stürzt jedesmal nach einer Weile ab, wenn ich NoisePacker-Module
  340. spiele. Die Programmierer dieser Abspiel-Routine haben etwas GRAUSAMES
  341. mit dem CIA gemacht, daß niemals im Multitasking hätte geschehen sollen !
  342. Wenn Sie einen NoisePacker-Abspieler ohne diese intensive CIA-Nutung
  343. haben, geben Sie ihn mir ! Bearbeiten Sie nicht wichtige Daten während oder
  344. nachdem Sie so ein Modul abgespielt haben !!
  345.  
  346. Da es sooo viele Musik-Programme auf dem Amiga gibt, ist es für mich
  347. unmöglich, alle existierenden Abspielroutinen einzubinden.  Um ihnen und
  348. mir die Möglichkeit zu geben, den PowerPlayer zum besten Modulabspieler,
  349. der je geschrieben wurde, zu erweitern, werde ich jede Abspiel-Routine, die
  350. mir zugesendet wird, einbauen, wenn folgendes erfüllt ist:
  351.  
  352. - Quellcode der Musik-Routine in ASSEMBLER, möglichst PC-Relativ.
  353.   Zur Zeit kann ich nur Abspielroutinen benutzen, die vom Verticalblank-
  354.   Interrupt aufgerufen werden. Der Quellcode muß auf einer 3.5"-Disk sein.
  355. - Beschreibung, wie man eine Erkennung von Modulen dieser Art durchführt.
  356.   Wenn Sie keine Ahnung haben senden Sie 3 oder mehr Module dieser Art mit
  357.   und ich finde es selber heraus.
  358. - 3 oder mehrere Songs, die mit der Routine abgespielt werden können, sollten
  359.   ebenfalls dabei sein. Ich muß die Routinen testen und ein Musik-Programm,
  360.   für das es weniger als 3 Songs gibt, ist sicherlich nicht gut.
  361. - Fügen Sie einen an sich adressierten Umschlag bei, mit 5 DM oder mehr
  362. - Wenn die Diskette auch nur einen Fehler hat, gehe ich davon aus, daß Sie
  363.   sie sowieso nicht mehr haben wollen und werfe sie weg. Also benutzen Sie
  364.   Disketten hoher Qualität und formatieren Sie sie vor der Benutzung !
  365.  
  366. Wenn Sie einige Features zum PowerPlayer dazu haben möchten, tun Sie
  367. folgendes:
  368.  
  369. - Schreiben Sie einen detailierten Brief mit allen neuen Features an die
  370.   Sie denken
  371. - Wenn Sie das Update mit einigen/allen ihrer Features haben wollen,
  372.   fügen Sie eine Diskette und einen an sich selbst adressierten Umschlag
  373.   hinzu
  374. - Fügen Sie 5 DM für all die Arbeit hinzu !
  375.  
  376. Wenn Sie ein Update haben wollen, tun Sie folgendes:
  377. - legen Sie eine Diskette und einen an Sie adressierten Umschlag bei
  378. - 5 DM für Unkosten und Arbeit !
  379. - Ich werde ihnen dann die aktuelle Version des PowerPlayers zukommen lassen
  380.  
  381. KEINE PANIK, wenn ich ihren Brief nicht gleich beantworte !  Ich habe nicht
  382. genug Zeit, den halben Tag mit meinem Computer zu verbringen.
  383.  
  384. Meine Adresse:    Stephan Fuhrmann
  385.         Erikstr. 30
  386.         W-2380 Schleswig
  387.         Germany
  388.